@database YamahaTX16WDatatype.guide
@author "Frank Hoffmann"
@wordwrap
@node Main "Yamaha TX16W Datatype document"
@{b}Yamaha TX16W Datatype@{ub} - Public Release 1
Version 39.4 (24.01.1994)
(c) 1994 by Frank Hoffmann
@{" Installation, Requirements & Tested " link IRT }
@{" About the Yamaha TX16W Fileformat   " link TXINFO }
@{" DISCLAIMER & LEGAL MATTERS          " link DISLEG }
@{" Features & TODO                     " link FEATODO }
@{" Known Bugs                          " link BUGS }
@{" ACKNOWLEDGEMENTS                    " link ACK }
@{" Histroy                             " link HISTORY }
@{" Author/Contact                      " link AUTHOR }
@endnode
@node IRT "INSTALLATION, REQUIREMENTS & TESTED"
This datatype is tested on a Amiga 4000 with Kickstart 3.1, but it should run on all machines with Kickstart 3.0 and above. Only 32Bit Prozessors (>=68020) are supported!.
To install just copy the files 
     TX16W
     TX16W.info 
@{ui}
to the drawer 
     sys:devs/datatypes
@{ui}
and the file
     TX16W.datatype
@{ui}
to the drawer
     sys:classes/datatypes
@{ui}
and reboot your machine.
@endnode
@node TXINFO "Yamaha TX16W Fileformat Information"
The TX16W is a 12bit music sampler manufactured by Yamaha. It has 3 sampling frequencies 16,33 and 50 hz. The samples can be stored on floppy disks which use the MS-Dos format and a subset of the MS-Dos Filesystem, so reading with CrossDos should be save, but never tried it.
File Extension : #?.Wxx with xx     (checked by datatype) *)
Magic Number   : "LM8953"           (checked by datatype)
*) All TX16W files have the same magic number, even utility files, so we have to check it.
@endnode
@node FEATODO "Features & TODO"
FEATURES
*Decode @{"TX16W sample files" link SVINFO} to 8 bit sample data  
*Normalizes the 8bit data (which is musch quicker)
METHODS
*OM_New to read from file
(near future)
*Normalize the 12 bit data for better quality ( but is much slower )
*Looppoint extraction
*Low memory detection & low memory conversion
(maybe)
*Implement other methods (Write)
*Prefs and shared library for conversion & general behaviour of sound data-
 types, based on a sound support library wich can convert and process sample
 data. ( Feel free to contact me for suggestions and help offers ) 
OTHER DATATYPE PROJECTS
-Maud ( also released )
-MIDI Sample Dump Standard ( on work )
-Sample Vision ( also released )
@endnode
@node DISLEG "Disclaimer & legal matters"
DISCLAIMER
THERE  IS  NO  WARRANTY  FOR  THE  PROGRAM,  TO  THE EXTENT PERMITTED BY
APPLICABLE  LAW.   EXCEPT  WHEN  OTHERWISE  STATED IN WRITING THE COPYRIGHT
HOLDER  AND/OR OTHER PARTIES PROVIDE THE PROGRAM ''AS IS'' WITHOUT WARRANTY
OF  ANY  KIND,  EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND FITNESS FOR A PARTICULAR
PURPOSE.   THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS  WITH  YOU.   SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
   IN  NO  EVENT  UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL  ANY  COPYRIGHT  HOLDER,  OR  ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
PROGRAM  AS  PERMITTED  ABOVE,  BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL,  SPECIAL,  INCIDENTAL  OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE  OR  INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA  OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES  OR  A  FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN  IF  SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
LEGAL MATTERS
This datatype is Public Domain. Do whatever you want with it. 
This datatype is based on the source code of the AIFF Datatype by 
Olaf 'Olsen' Barthel <olsen@sourcery.han.de> which is public domain.
@endnode
@node ACK "ACKNOWLEDGEMENT"
Many thanks to Olaf 'Olsen' Barthel for his help in designing datatypes.
@endnode 
@node BUGS "Bugs"
no known bugs (yet), but there is no 100% bug free software...
contact the @{" Author " link AUTHOR } for bug reports.
@endnode
@node HISTORY "Release History"
Version 39.4    - archive bug fixed.
                - more save sample data length.
                - library and file open cleaned.
Version 39.3    - first public release.
@endnode
@node AUTHOR "Author"
Frank Hoffmann
E-Mail (temporary):
hoffmann@ls11.informatik.uni-dortmund.de
permanent address:
Hochdahler Str.134
40724 Hilden
(feel free to contact me via E-Mail for bug reports, suggestions, projects...)
@endnode